Predefined Item Properties

The tables below are a summary of the attributes defined by Apis Hive, which may be applied to any item in Apis Hive.

Some Apis Hive attributes have enumerated values, e.g. you may select between a predefined list of attribute values. Check the list of enumerated values and matching integers to get an overview of these attributes.

Internal attributes

Note: These attributes should not be added

IDNameDescriptionType
5000HandleHandle of an item - used when persisting the runtime state.4 byte integer
5001TypeIDThe type ID of an item.4 byte integer
5003ItemIDThe name of the item.string
5002InitValueThe initial value of an item.-
5045InitValueQualityInitial value quality of an item (only valid when having an InitValue).-
5046InitValueTimestampInitial value timestamp of an item (only valid when having an InitValue).-
5047InitVQTFromHoneystoreIf true, the initial value, quality and timestamp will be fetched from the last logged sample in Apis Honeystore.Note! To successfully use this attribute, the item in question must be logged to Honeystore by an ApisLoggerBee module.Boolean

Alternative value presentations

IDNameDescriptionType
5004RawValueThe Raw 32-bit untranslated value.4 byte integer
5005ScaleLinear transformation multiplier, a floating-point value.8 byte real
5006OffsetLinear transformation addend, floating point value.8 byte real

Vector and matrix attributes

IDNameDescriptionType
5007DimensionThe number of elements for a vector item (vector only)2 byte unsigned integer
5008RowsThe number of rows for a matrix item (matrix item only)2 byte unsigned integer
5009ColumnsThe number of columns for a matrix item (matrix item only)2 byte unsigned integer

Item location attributes

IDNameDescriptionType
5010ProcStationIDProcess station ID, a 32 bit integer4 byte integer
5011ProcAreaProcess areastring
5012LocationGeneral location attribute stringstring
5013StationStation namestring

Object attributes

IDNameDescriptionType
5015ObjectClassThe object class this item belongs tostring
5016ObjectInstanceThe object instance this item belongs tostring
5017ObjectPropertyThe object property this item representsstring

Item bus/network location attributes

IDNameDescriptionType
5020AddressBus/network address 14 byte integer
5021Address2Bus/network address 24 byte integer
5022Address3Bus/network address 34 byte integer
5023Address4Bus/network address 44 byte integer
5026SegmentBus/network segment number2 byte integer
5028SegmentPosPosition within segment2 byte integer
IDNameDescriptionType
5030SrcItemIDItem ID in source (often defaults to Item Name in Apis)string
5031SrcUaNodeIdUA NodeID in source, mostly relevant from OPC UA communication modules.string
5032InstrumentNameInstrument namestring
IDNameDescriptionType
5034SourceThe source of the itemstring
5035TableThe table of the itemstring
5036RecordThe record of the itemstring
5037FieldThe field of the itemstring

Directional attributes

IDNameDescriptionType
5040DirectionDirection flag, Input when false or Output when trueBoolean

Display attributes

IDNameDescriptionType
5050DisplayOperator display associated with the itemstring
5054XposX-pos, graphical x-position of the item4 byte integer
5055YposY-pos, graphical y-position of the item4 byte integer
5056WidthWidth, width of the item4 byte integer
5057HeightHeight, height of the item4 byte integer

Device attributes

IDNameDescriptionType
5060DevTypeDevice typestring
5062DevVendorDevice vendorstring
5064DevSerNumDevice serial numberstring
IDNameDescriptionType
5070MaxStringLengthAn indication of the maximum length of the value of a string item. Must be used when logging string items to the Apis Honeystore historian, to control how many characters will be stored for each sample.4 byte integer
5071MaxCacheDurationWhen the item are logged to Apis Honeystore, the maximum duration in seconds, for the item cache when the item is logged by ApisLoggerBee!4 byte unsigned integer
5080LowerBoundLBound, The lower bound of items in vector4 byte real
5081UpperBoundUBound, The upper bound of items in vector4 byte real
5090RowNamesThe names of the rows in a vector or matrix, separated by ';'array of strings
5091ColNamesThe names of the columns in a matrix, separated by ';'array of strings
5100ArgumentItemAn item whose value is used to calculate this itemstring
5105FormatStringA general purpose format string, used when applying string formatting to calculate the value of this item.string
5110ExpressionAn expression used to calculate the value of this itemstring
5111ExpressionsAn array of expressions used to calculate the value of this itemarray of string
5130RateAn attribute which keeps the value rate8 byte unsigned integer
5135HorizonAn attribute which keeps the value horizon8 byte unsigned integer
5220CoefficientsVector of coefficients used for calculation purposesarray of 8 byte real

Composition attributes

IDNameDescriptionType
5500ParentThe Item handle of the parent item to this item, an item in the same module as this item.4 byte integer
5502ParentItemThe Item name of the parent item to this item, an item in the same module as this item.string
5505AggregateThe item handle of the aggregate this item is part of4 byte integer
5510InputItemsLocalArray of item handles regarded as input-items to this item, only for items in the same module.array of 4 byte integers
5511InputItemsArray of item handles regarded as input-items to this item, for items in any module.array of 4 byte integers
5514InputFlagsFlags associated with the inputsarray of 4 byte integers
5520OutputItemsLocalArray of item handles regarded as output-items from this item, only for items in the same module.array of 4 byte integers
5521OutputItemsArray of item handles regarded as output-items from this item, for items in any module.array of 4 byte integers
5524OutputFlagsFlags associated with the outputsarray of 4 byte integers

Alarm attributes

IDNameDescriptionType
5600AlmSeveritySeverity of alarm associated with this item (according to OPC AE). 1 is the lowest, while 1000 is the highest.4 byte integer
5610AlmSeverityListSeverity of alarm associated with this item (according to OPC AE). 1 to 1000 as the allowable range.string
5630AlmNormalStateThe normal state of a discrete alarm/event (according to OPC AE) associated with this item. A deviation from this value will generate a discrete event.Variant
5635AlmActiveDelayPeriodsThe number of periods an item is active before an alarm is raised.2 byte integer
5640AlmWatchdogPeriodsThe max number of periods this item can have the same value before a watchdog alarm is raised.2 byte integer
5650AlmInhibitItemThe Item ID of another item whose value will be used to inhibit this alarm if set to true. Changed from a string to a 4 byte unsigned integer at start-up, i.e. 4 byte unsigned integer runtimestring
5652AlmInhibitOffDelayThe time in milliseconds the alarm inhibit state is delayed before going off4 byte integer
5653AlmResetItemThe Item ID of another item, whose value (when true) will reset the alarm of the source when it is inhibittedstring

Chronical attributes

IDNameDescriptionType
5250ChronicalEventTypeName of the eventtype to use for new events. This will override the default eventtype generated by the AlarmArea modulestring
5252ChronicalParentPath to an eventsource to use as the parent source for the item. This will override the default location of the items eventsourcestring
5255ChronicalSourceNameValue of the SourceName field on new events. This will override the default sourcename used by the AlarmArea modulestring

General purpose attributes

IDNameDescriptionType
5800Text1General purpose attributestring
5801Text2General purpose attributestring
5802Text3General purpose attributestring
5803Text4General purpose attributestring
5810ActivationCountThe number of times this item has been activated4 byte unsigned integer
5811ExecutionCountThe number of times this item has been executed4 byte unsigned integer
5900UserLevThe user level needed to access this item 0 -255 (BYTE)2 byte unsigned integer
5940ExtendedRightsExtended access rights, used to restrict access to items beyond the OPC Item attributes.1 byte unsigned integer
5950TypeFlagsThis item is protected from users without the required level4 byte integer

Data validation attributes

IDNameDescriptionType
5670DvMethodThe method that decides which data validation tests to use. See "Data Validation Method".2 byte unsigned integer
5672DvHiRangeThe high limit for a DV range check8 byte real
5673DvLoRangeThe low limit for a DV range check8 byte real
5674DvMaxRocThe maximum rate of change for a DV rate of change check8 byte real
5676DvWdTimeThe time limit in seconds for a DV watchdog check8 byte real
5677DvCompareItemThe comperand item to use when using any of the difference data-validation methods, ie. The difference is calculated by subtracting the value of the item referenced from the value of the item owning this attribute.string
5678DvCompareValueThe compare-value to use when using any of the difference data-validation methods. i.e. If the difference is bigger than the value of this attribute, the data is invalid.8 byte real
5680DvSPCUCLThe upper control limit in SPC8 byte real
5681DvSPCLCLThe lower control limit in SPC8 byte real
5682DvSPCTestThe value assigned causes tests to be performed (multiple selects possible)string
5683DvSPCUSLThe upper SPC specification limit item reference, specified as an item reference or value directly.string
5684DvSPCLSLThe lower SPC specification limit item reference, specified as an item reference or value directly.string
5685DvSPCCLThe central line in SPC, specified as an item reference or value directly. If CL is not specified, UCL and LCL will be used to calculate it.string
5690DvSubstMethodThis method decides which data validation substitute value to use, see Data Validation Substitution Method.2 byte unsigned integer
5692DvAltExtItemAn alternative external item, to fetch a DV substitute value fromstring
5695DvSuppressAlarmIf true (default behaviour), successive DV alarms of same subcondition are suppressed from being notified to the Alarm server of this Hive instance, ie. suppressed from any AE clients and Alarm database. If false, no DV alarms are suppressed.Boolean
IDNameDescriptionType
5960ExtItemMetaTransferAn enum deciding what kind of metadata to transfer from source to destination external item(s).
EngineeringUnit - The EU and Unit attributes are transferred.

Description - The Description attribute is transferred.

EURange - The High/Low EU attributes are transferred.

InstrumentRange - The High/Low Instrument Range attributes are transferred.
4 byte unsigned integer
5970MonMethodThe method that decides how external items are monitored. See Pulse Monitoring2 byte unsigned integer
5971MonTrueValueThis value is set on the monitoring item if the monitoring method is trueVariant
5972MonFalseValueThis value is set on the monitoring item if the monitoring method is falseVariant
5980ExtTransferCtrlMethodThe control method that decides when external items are transferred. See "External Item Data Transfer Control Methods"2 byte unsigned integer
5982ExtTransferCtrlItemThe Item ID of another item, whose value will control the transfer of external item values to this itemstring
5984ExtTransferCtrlArgumentThe argument to use with the methodstring
5986ExtTransferCtrlInhibitQualityThe quality to set when external item value transfer is inhibited. One of:
none=0
quality: bad=65536
quality: uncertain=65600
quality: good=65728
quality: bad:config error=65540
quality: bad:not connected=65544
quality: bad:device failure=65548
quality: bad:sensor failure=65552
quality: bad:last known value=65556
quality: bad:comm failure=65560
quality: bad:out of service=65564
quality: bad:waiting for initial data=65568
quality: uncertain:last usable=65604
quality: uncertain:sensor not accurate=65616
quality: uncertain:engineering units exceeded=65620
quality: uncertain:sub normal=65624
quality: good:local override=65752
4 byte unsigned integer
5990ExtRowSelectThe vector/matrix row in an external vector/matrix item to copy to this scalar item2 byte integer
5991ExtColSelectThe vector/matrix column in an external vector/matrix item to copy to this scalar item2 byte integer
5994ExternalItem FiltersOne or more item name template(s) to use for connecting many external items. When set not an empty array, this attribute takes control over the external item configuration for its item. This means that upon startup, and when changing this attribute at run-time, an operation is triggered that resolves all matching items and connects them to the as external items. Any existing connections no longer matching the filter(s) are removed. An empty array is ignored, and external items can be configured as if this attribute were not present on the item. To make the ExternalItem Filters perform better, one should avoid having a wildcard '*' in the first part of the filter, before the first '.' separating the item names from its module name part.array of string
5998ExtItemPaddingValueA padding value to be used when assigning missing external item values to an array item, ie. when assigning a source array item of dim 3 to a target item of dim 5-
5999ExtItemOverrideMethodThis attribute decides what method to use when assigning a value from an external item, see external item External Item Override Methods2 byte unsigned integer

External item attributes

IDNameDescriptionType
20000ExternalItem1External Item (Apis item name of the external item which will be automatically copied to this item)string
85535ExternalItemMaxMax external item IDstring

PDS Connection attributes

IDNameDescriptionType
5714ProcessCellThe PDS Process Cell associated with this item4 byte integer
5715ProcessUnitClassThe PDS Process Unit Class associated with this item4 byte integer
5716ProcessUnitThe PDS Process Unit associated with this item4 byte integer
5718EquipmentThe PDS Equipment associated with this item4 byte integer
5730IdentifierThe PDS Identifier associated with this item4 byte integer
5732MaterialDefinitionThe PDS Material Definition associated with this item4 byte integer
5734MaterialClassThe PDS Material Class associated with this item4 byte integer
5736MaterialQualityThe PDS Material Quality associated with this item4 byte integer
5742CarrierClassThe PDS Carrier Class associated with this item4 byte integer
5744CarrierThe PDS Carrier associated with this item4 byte integer
5752DataClassThe PDS Data Class associated with this item4 byte integer
5754DataDefinitionThe PDS Data Definition associated with this item4 byte integer
5764EventSourceThe PDS Event Source associated with this item4 byte integer
5774EUThe PDS Engineering unit (engineering unit) associated with this item4 byte integer
5775GuiEUThe default GUI PDS Engineering Unit associated with this item.4 byte integer
IDNameDescriptionType
5300DEPRECATED_MessageTypeIDDEPRECATED! The MessageTypeID of an ApisMessage4 byte unsigned integer
5301DEPRECATED_MessageCategoryDEPRECATED! The MessageCategory of an ApisMessage4 byte unsigned integer
IDNameDescriptionType
6000DEPRECATED_GemVIDDEPRECATED! SECS/GEM Variable ID4 byte unsigned integer
6001DEPRECATED_GemVIDClassDEPRECATED! SECS/GEM Variable Class ID1 byte unsigned integer
6010DEPRECATED_GemCEIDTrigDEPRECATED! SECS/GEM Collection Event ID for item used as trigger. Values below 1000 are reserved for internal usage, and will be ignored on item attributes.4 byte unsigned integer
6020DEPRECATED_GemTIDSndDEPRECATED! SECS/GEM Terminal ID for equipment generated text4 byte unsigned integer
6021DEPRECATED_GemTIDRcvDEPRECATED! SECS/GEM Terminal ID for host generated text4 byte unsigned integer
6030DEPRECATED_GemALIDDEPRECATED! SECS/GEM Alarm ID of an alarm. Values below 1000 are reserved for internal usage, and will be ignored on item attributes.4 byte unsigned integer
6031DEPRECATED_GemALCEIDOnDEPRECATED! SECS/GEM Alarm CEID for an alarm going ON.4 byte unsigned integer
6032DEPRECATED_GemALCEIDOffDEPRECATED! SECS/GEM Alarm CEID for an alarm going OFF.4 byte unsigned integer
IDNameDescriptionType
6100DEPRECATED_IEC104TypeIDDEPRECATED! IEC104 TypeID, used by IEC104 server to expose Apis items, enumeration of supported IEC104 TypeIDs:Not in use=0Single point information[Bool]=1Bitstring 32 bits[Int32,UInt32]=7Measured value[Float32]=131 byte unsigned integer
IDNameDescriptionType
5150DEPRECATED_HSDimensionIDDEPRECATED! This attribute maps this item value to instances of a Dimension definition in the Apis HoneyStore Indexing databasestring
5151DEPRECATED_HSMeasurementIDDEPRECATED! This attribute maps this item value to instances of a Measurement definition in the Apis HoneyStore Indexing databasestring
5152DEPRECATED_HSLocationIDDEPRECATED! This attribute maps this item value to instances of a Location definition in the Apis HoneyStore Indexing databasestring